package com.zcm.service.weibo.load;

import com.zcm.service.weibo.LoadServices;

import net.sf.json.JSONObject;

/**
 * 与评论相关的拉取接口
 * @author Administrator
 *
 */
public interface CommentLoadOperators extends LoadServices {
	
	/**
	 * 根据微博ID返回某条微博的评论列表
	 * @param id          需要查询的微博ID.
	 * @param sinceId     若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0.
	 * @param maxId       若指定此参数，则返回ID小于或等于max_id的微博，默认为0.
	 * @param count       单页返回的记录条数，默认为50.
	 * @param page        返回结果的页码，默认为1.
	 * @param filterByAuthor  作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0.
	 * @return
	 */
	public JSONObject loadComments(String id, String sinceId, String maxId, int count, int page, int filterByAuthor);
	
	/**
	 * 获取当前登录用户所发出的评论列表
	 * @param id          需要查询的微博ID.
	 * @param sinceId     若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0.
	 * @param maxId       若指定此参数，则返回ID小于或等于max_id的微博，默认为0.
	 * @param count       单页返回的记录条数，默认为50.
	 * @param page        返回结果的页码，默认为1.
	 * @param filterByAuthor  作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0.
	 * @return
	 */
	public JSONObject loadCommentsByMe(String id, String sinceId, String maxId, int count, int page, int filterByAuthor);
	
	/**
	 * 获取当前登录用户所接收到的评论列表
	 * @param id          需要查询的微博ID.
	 * @param sinceId     若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0.
	 * @param maxId       若指定此参数，则返回ID小于或等于max_id的微博，默认为0.
	 * @param count       单页返回的记录条数，默认为50.
	 * @param page        返回结果的页码，默认为1.
	 * @param filterByAuthor  作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0.
	 * @param filterBySource  获取当前登录用户所接收到的评论列表
	 * @return
	 */
	public JSONObject loadCommentsToMe(String id, String sinceId, String maxId, int count, int page, int filterByAuthor);
	
	
	/**
	 * 获取当前登录用户的最新评论包括接收到的与发出的
	 * @param id          需要查询的微博ID.
	 * @param sinceId     若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0.
	 * @param maxId       若指定此参数，则返回ID小于或等于max_id的微博，默认为0.
	 * @param count       单页返回的记录条数，默认为50.
	 * @param page        返回结果的页码，默认为1.
	 * @return
	 */
	public JSONObject loadCommentsTimeline(String id, String sinceId, String maxId, int count, int page);
	
	/**
	 * 根据评论ID批量返回评论信息
	 * @param cids 需要查询的批量评论ID，用半角逗号分隔，最大50。
	 * @return
	 */
	public JSONObject loadCommentBatchByCIds(String... cids);
}
